home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Prog / U-Z / ViewIt™ 2.2 Shareware / FaceWare / FaceWare.rsrc / TEXT_1321_BC11. Examples.txt < prev    next >
Encoding:
Text File  |  1993-10-19  |  12.8 KB  |  206 lines

  1. Example Controls
  2.   The FCTLs numbered 1311 to 1340 in the Import menu (the "+" menu) are examples of BaseCt-based controls.  A brief description of each example control is presented below to help you understand how the controls can be modified to suit your own purposes.
  3.  
  4. 1311 Static Line
  5. Use:  as line between groups of controls
  6. Setup:  solid, no title, zero frame pen size, 1-pixel indent, static, linked to system PAT# 0 (Max = index into PAT# resource)
  7. Common Variations:  color, pattern (change Max)
  8. Data Link:  not applicable
  9. More Info:  see "Icons, Picts, ..." topic
  10.  
  11. 1312 Static Box
  12. Use:  as transparent box around other controls
  13. Setup:  not solid, no title, non-zero frame pen size, static, no resource link
  14. Common Variations:  frame size, roundness, color
  15. Data Link:  not applicable
  16. More Info:  see "Static Text" topic
  17.  
  18. 1313 Static Text
  19. Use:  displays control title as static text
  20. Setup:  not solid, non-empty title, no frame, static, no resource link
  21. Common Variations:  text font, size, style, color
  22. Data Link:  control title <-> any program variable
  23. More Info:  see "Static Text" topic
  24.  
  25. 1314 Editable Text
  26. Use:  displays editable text (initially equal to title)
  27. Setup:  solid, 1-pixel frame, 2-pixel indent, editable, no resource link, Idle message
  28. Common Variations:  text font, size, style, color
  29. Data Link:  editable text <-> any program variable
  30. More Info:  see "Editable Text" topic
  31.  
  32. 1315 Ed Text & Style
  33. Use:  displays editable text (initially equal to title) with user-selectable text style (via FSSC menus)
  34. Setup:  solid, 1-pixel frame, 2-pixel indent, editable, no resource link, Idle message, "Supports FSSC" option checked (supports FSSC menus)
  35. Common Variations:  text font, size, style, color
  36. Data Link:  editable text <-> any program variable
  37. More Info:  see "Editable Text" topic
  38.  
  39. 1316 clut Pop-Up
  40. Use:  displays color from linked clut resource and pops up color palette when clicked
  41. Setup:  solid, 1-pixel frame, 1-pixel indent, has shadow, "List or Menu" type, linked to a clut (Min = first, Max = last, Value = current clut index)
  42. Common Variations:  frame and body color
  43. Data Link:  control value <-> integer variable
  44. More Info:  see "Pop-Up Palettes" topic
  45.  
  46. 1317 Color Picker
  47. Use:  displays control's content color and opens Color Picker or pops up color palette when clicked
  48. Setup:  solid, 1-pixel frame, 1-pixel indent, has shadow, "List or Menu" type, linked to clut 1310
  49. Common Variations:  frame and body color
  50. Data Link:  content color <-> RGB program variable
  51. More Info:  see "Color Pickers" topic
  52.  
  53. 1318 ICON Icon
  54. Use:  displays static linked ICON resource
  55. Setup:  solid, no frame, static, linked to ICON
  56. Common Variations:  sometimes used as Button, Check Box, or Radio Button
  57. Data Link:  rarely applicable
  58. More Info:  see "Icons, Picts, ..." topic
  59.  
  60. 1319 MENU Flags
  61. Use:  pops up linked MENU resource when clicked and toggles selected items on/off (checked/unchecked)
  62. Setup:  solid, centered title, 1-pixel frame, shadow, "List or Menu" type, linked to MENU, VarCode = 2 (arrow in title) + 8 (auto-process selections) + 32 (center title vertically)
  63. Common Variations:  text font, size, style, color
  64. Data Link:  32 bit flags corresponding to checked state of menu items <-> integer variable
  65. More Info:  see "Menu Controls" topic
  66.  
  67. 1320 MENU Pop-Up
  68. Use:  pops up linked MENU resource when clicked and checks selected item (unchecking all others)
  69. Setup:  solid, centered title, 1-pixel frame, shadow, "List or Menu" type, linked to MENU, VarCode = 1 (single selection) + 4 (display menu above control) + 8 (auto-process selections)
  70. Common Variations:  text font, size, style, color, addition of arrow (add 2 to VarCode)
  71. Data Link:  checked item # <-> integer variable
  72. More Info:  see "Menu Controls" topic
  73.  
  74. 1321 MENU Pull-Down
  75. Use:  pops up linked MENU resource when clicked but does not auto-check/uncheck any menu selections
  76. Setup:  solid, centered title, 1-pixel vertical pen size, 0-pixel horizontal pen, "List or Menu" type, linked to MENU, VarCode = 0
  77. Common Variations:  frame size and thickness, shadow, text font, size, style, color, arrow in title
  78. Data Link:  not applicable
  79. More Info:  see "Menu Controls" topic
  80.  
  81. 1322 Style Picker
  82. Use:  pops up linked MENU resource that contains hierarchical items linked to ViewIt's standard Font, Size, Style, and Color (FSSC) menus (performs same role as the above A icon menu in this window)
  83. Setup:  solid, empty title, 1-pixel frame, shadow, "List or Menu" type, linked to MENU, VarCode = 2 (show down arrow)
  84. Common Variations:  frame size and thickness, non-empty title, text font, size, style, color
  85. Data Link:  not applicable
  86. More Info:  see "Menu Controls" topic
  87.  
  88. 1323 PAT# Pattern
  89. Use:  displays pattern from linked PAT# resource
  90. Setup: solid, no frame, static, linked to a PAT# (Min = first, Max = last, Value = current PAT# index, OR Min = 0, Max = PAT# index, Value = 0)
  91. Common Variations:  content color
  92. Data Link:  control value <-> integer variable
  93. More Info:  see "Icons, Picts, ..." topic
  94.  
  95. 1324 PAT# Pop-Up
  96. Use:  displays pattern from linked PAT# resource and pops up pattern palette when clicked
  97. Setup:  solid, 1-pixel frame, 1-pixel indent, has shadow, "List or Menu" type, linked to a PAT# (Min = first, Max = last, Value = current PAT# index)
  98. Common Variations:  frame, body, & content color
  99. Data Link:  control value <-> integer variable
  100. More Info:  see "Pop-Up Palettes" topic
  101.  
  102. 1325 PICT Button
  103. Use:  displays linked PICT resource and acts like a button when clicked
  104. Setup:  solid, 1-pixel rounded frame, button-type, linked to PICT, non-zero Max V and Max H content (so picture is not stretched)
  105. Common Variations:  also used as Check Box, Radio Button, or simple static picture
  106. Data Link:  not applicable
  107. More Info:  see "Icons, Picts, ..." topic
  108.  
  109. 1326 PICT Pop-Up
  110. Use:  displays linked PICT resource and pops up PICT palette when clicked
  111. Setup:  solid, 1-pixel frame, shadow, list or menu type, linked to multiple PICT resources (Min = first, Max = last, Value = current PICT res ID), VarCode = 32 to center PICT in content area
  112. Common Variations:   frame, body, & content color
  113. Data Link:   control value <-> integer variable
  114. More Info:  see "Pop-Up Palettes" topic
  115.  
  116. 1327 SICN Arrows
  117. Use:  displays small icons from linked SICN resource that act like buttons when clicked
  118. Setup:  solid, no frame, non-zero Max V and Max H content, "Button" type, continuously returns control on hit (VarCode = 128), linked to an SICN (Min = unhilited, Max = hilited, Value = current state as index into SICN list)
  119. Common Variations:  frame, body, & content color, indent and content size (the 0 indent used in these examples may need to be changed for other SICN lists to get the small icons drawn in the desired position)
  120. Data Link:  not applicable to buttons
  121. More Info:  see "Btn, Chk, & Rad" topic
  122.  
  123. 1328 SICN Chk Box
  124. Use:  displays small icon from linked SICN resource and acts like a check box when clicked (this example mimics the standard check box)
  125. Setup:  solid, no frame, left-justified, "Check Box" type, VarCode = 32 (align according to justification, center vertically, and display title), and linked to an SICN (Min = unchecked, Min + 1 = hilited unchecked, Max - 1 = hilited checked, Max = checked, Value = current state as index into SICN list)
  126. Common Variations:  body & content color
  127. Data Link:  control value <-> integer variable where an unchecked (Value = Min) control returns 0 to the program, and checked (Value = Max) returns 1
  128. More Info:  see "Btn, Chk, & Rad" topic
  129.  
  130. 1329 SICN Rad Btn
  131. Use:  displays small icon from linked SICN resource and acts like radio button when clicked (this example mimics the standard radio button)
  132. Setup: solid, no frame, left-justified, "Radio Button" type, VarCode = 32 (align according to justification, center vertically, and display title), and linked to an SICN (Min = unchecked, Min + 1 = hilited unchecked, Max - 1 = hilited checked, Max = checked, Value = current state as index into SICN list)
  133. Common Variations:  body & content color
  134. Data Link:  control value <-> integer variable where an unchecked (Value = Min) control returns 0 to the program, and checked (Value = Max) returns 1
  135. More Info:  see "Btn, Chk, & Rad" topic
  136.  
  137. 1330 SICN Pop-Up
  138. Use:  displays small icon from linked SICN resource and pops up small icon palette when clicked
  139. Setup:  solid, 1-pixel frame, non-zero Max V and Max H content, negative indent, has shadow, "List or Menu" type, linked to an SICN (Min = first, Max = last, Value = current SICN index)
  140. Common Variations:  frame, body, & content color, indent and content size (the -1 indent and non-zero content Max V and Max H seen in the example pop-up are used to align the drawn icon within the small content area of the control - you may need to change these settings when using other SICN lists)
  141. Data Link:  control value <-> integer variable
  142. More Info:  see "Pop-Up Palettes" topic
  143.  
  144. 1331 STR# Text
  145. Use:  displays control title as static text, replacing "^1", "^2", etc., with strings from linked STR#
  146. Setup:  solid, title with "^n" substrings, no frame, static, linked to STR#, Min = Max = Value = 0
  147. Common Variations:  text font, size, style, color
  148. Data Link:  control title <-> any program variable
  149. More Info:  see "Static Text" topic
  150.  
  151. 1332 STR# List
  152. Use:  displays scrollable list of strings from linked STR# resource
  153. Setup:  solid, 1-pixel thick frame, "List or Menu" type, linked to STR#, VarCode = 128 (single select)
  154. Common Variations:  font, size, style, color, and many VarCode options
  155. Data Link:  selected item # <-> integer variable
  156. More Info:  see "Scrollable Lists" topic
  157.  
  158. 1333 STR# 3D Btn
  159. 1334 cicn 3D Btn
  160. Use:  displays resource (in this case cicn) defined by string in linked STR# or by resource link, and acts as button when clicked
  161. Setup:  no frame, "Button" type, returns on hit, linked to an STR# list or multiple cicn resources (Min = unhilited, Max = hilited, Value = current state as index into STR# or cicn res ID), VarCode = 16 (display title) + 64 (don't draw mask)
  162. Common Variations:  title style & color
  163. Data Link:  not applicable to buttons
  164. More Info:  see "Btn, Chk, & Rad" topic
  165.  
  166. 1335 cicn 3D Chk Box
  167. Use:  displays resource (in this case cicn) defined by resource link, and acts as check box when clicked
  168. Setup:  no frame, "Check Box" type, linked to cicn resources (Min = unchecked, Max = checked, Value = current state as cicn resource ID), VarCode = 32 (align according to justification, center vertically, and display title)
  169. Common Variations:  title style & color
  170. Data Link:  control value <-> integer variable where an unchecked (Value = Min) control returns 0 to the program, and checked (Value = Max) returns 1
  171. More Info:  see "Btn, Chk, & Rad" topic
  172.  
  173. 1336 cicn 3D Rad Btn
  174. Use:  displays resource (in this case cicn) defined by resource link, and acts as radio button when clicked
  175. Setup:  no frame, "Radio Button" type, linked to cicn resources (Min = unchecked, Max = checked, Value = current state as cicn resource ID), VarCode = 32 (align according to justification, center vert., and display title)
  176. Common Variations:  title style & color
  177. Data Link:  control value <-> integer variable where an unchecked (Value = Min) control returns 0 to the program, and checked (Value = Max) returns 1
  178. More Info:  see "Btn, Chk, & Rad" topic
  179.  
  180. 1337 cicn Excel Btn
  181. Use:  displays resource (in this case cicn) defined by resource link and acts as button if clicked;  the cicn displayed is similar to the ones used in Excel
  182. Setup:  no frame, no title, "Button" type, returns on hit, linked to cicn resources (Min = unhilited, Max = hilited, Value = current state as cicn resource ID), VarCode = 32 (align according to justification, center vertically, do not stretch)
  183. Common Variations:  other color icons
  184. Data Link:  not applicable to buttons
  185. More Info:  see "Btn, Chk, & Rad" topic
  186.  
  187. 1338 Dial Bar
  188. Use:  displays current control value as solid bar in control's content area
  189. Setup:  solid, 1-pixel thick frame, "Dial Control" type, Value - Min / Max - Min determines bar size
  190. Common Variations:  frame, body, & content color, frame and indent size, orientation, VarCode options
  191. Data Link:  control value <-> integer or real
  192. More Info:  see "Dial Controls" topic
  193.  
  194. 1339 Dial Round
  195. Use:  displays current control value as wedge in rounded control's content area
  196. Setup:  solid, 1-pixel thick frame, 2-pixel indent, rounded, "Dial Control" type, Value - Min / Max - Min determines wedge position, VarCode = 2 (round dial) + 4 (fill current value only)
  197. Common Variations:  frame, body, & content color, frame and indent size, VarCode options
  198. Data Link:  control value <-> integer or real
  199. More Info:  see "Dial Controls" topic
  200.  
  201. 1340 Dial w/ Thumb
  202. Use:  displays current control value as "thumb" box in control's content area
  203. Setup:  solid, 1-pixel thick frame, "Dial Control" type, Value - Min / Max - Min determines thumb position, VarCode = 4 (fill current value only)
  204. Common Variations:  frame, body, & content color, frame and indent size, orientation, VarCode options
  205. Data Link:  control value <-> integer or real
  206. More Info:  see "Dial Controls" topic